/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Applications / Python 1.3 / source code / Doc / libmactcp.tex

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 6d 61 63 74 63 | 70 7d 7d 0d 5c 62 69 6d |de{mactc|p}}.\bim|
|00000030| 6f 64 69 6e 64 65 78 7b | 6d 61 63 74 63 70 7d 0d |odindex{|mactcp}.|
|00000040| 0d 5c 72 65 6e 65 77 63 | 6f 6d 6d 61 6e 64 7b 5c |.\renewc|ommand{\|
|00000050| 69 6e 64 65 78 73 75 62 | 69 74 65 6d 7d 7b 28 69 |indexsub|item}{(i|
|00000060| 6e 20 6d 6f 64 75 6c 65 | 20 6d 61 63 74 63 70 29 |n module| mactcp)|
|00000070| 7d 0d 0d 54 68 69 73 20 | 6d 6f 64 75 6c 65 20 70 |}..This |module p|
|00000080| 72 6f 76 69 64 65 73 20 | 61 6e 20 69 6e 74 65 72 |rovides |an inter|
|00000090| 66 61 63 65 20 74 6f 20 | 74 68 65 20 4d 61 63 69 |face to |the Maci|
|000000a0| 6e 74 6f 73 68 20 54 43 | 50 2f 49 50 20 64 72 69 |ntosh TC|P/IP dri|
|000000b0| 76 65 72 0d 4d 61 63 54 | 43 50 5c 40 2e 20 54 68 |ver.MacT|CP\@. Th|
|000000c0| 65 72 65 20 69 73 20 61 | 6e 20 61 63 63 6f 6d 70 |ere is a|n accomp|
|000000d0| 61 6e 79 69 6e 67 20 6d | 6f 64 75 6c 65 20 5c 63 |anying m|odule \c|
|000000e0| 6f 64 65 7b 6d 61 63 64 | 6e 72 7d 20 77 68 69 63 |ode{macd|nr} whic|
|000000f0| 68 20 70 72 6f 76 69 64 | 65 73 20 61 6e 0d 69 6e |h provid|es an.in|
|00000100| 74 65 72 66 61 63 65 20 | 74 6f 20 74 68 65 20 6e |terface |to the n|
|00000110| 61 6d 65 2d 73 65 72 76 | 65 72 20 28 61 6c 6c 6f |ame-serv|er (allo|
|00000120| 77 69 6e 67 20 79 6f 75 | 20 74 6f 20 74 72 61 6e |wing you| to tran|
|00000130| 73 6c 61 74 65 20 68 6f | 73 74 6e 61 6d 65 73 20 |slate ho|stnames |
|00000140| 74 6f 0d 69 70 2d 61 64 | 64 72 65 73 73 65 73 29 |to.ip-ad|dresses)|
|00000150| 2c 20 61 20 6d 6f 64 75 | 6c 65 20 5c 63 6f 64 65 |, a modu|le \code|
|00000160| 7b 4d 41 43 54 43 50 7d | 20 77 68 69 63 68 20 68 |{MACTCP}| which h|
|00000170| 61 73 20 73 79 6d 62 6f | 6c 69 63 20 6e 61 6d 65 |as symbo|lic name|
|00000180| 73 20 66 6f 72 0d 63 6f | 6e 73 74 61 6e 74 73 20 |s for.co|nstants |
|00000190| 63 6f 6e 73 74 61 6e 74 | 73 20 75 73 65 64 20 62 |constant|s used b|
|000001a0| 79 20 4d 61 63 54 43 50 | 20 61 6e 64 20 61 20 77 |y MacTCP| and a w|
|000001b0| 72 61 70 70 65 72 20 6d | 6f 64 75 6c 65 20 5c 63 |rapper m|odule \c|
|000001c0| 6f 64 65 7b 73 6f 63 6b | 65 74 7d 0d 77 68 69 63 |ode{sock|et}.whic|
|000001d0| 68 20 6d 69 6d 69 63 73 | 20 74 68 65 20 5c 55 4e |h mimics| the \UN|
|000001e0| 49 58 7b 7d 20 73 6f 63 | 6b 65 74 20 69 6e 74 65 |IX{} soc|ket inte|
|000001f0| 72 66 61 63 65 20 28 61 | 73 20 66 61 72 20 61 73 |rface (a|s far as|
|00000200| 20 70 6f 73 73 69 62 6c | 65 29 2e 20 20 49 74 20 | possibl|e).  It |
|00000210| 6d 61 79 0d 6e 6f 74 20 | 62 65 20 61 76 61 69 6c |may.not |be avail|
|00000220| 61 62 6c 65 20 69 6e 20 | 61 6c 6c 20 4d 61 63 20 |able in |all Mac |
|00000230| 50 79 74 68 6f 6e 20 76 | 65 72 73 69 6f 6e 73 2e |Python v|ersions.|
|00000240| 0d 0d 41 20 63 6f 6d 70 | 6c 65 74 65 20 64 65 73 |..A comp|lete des|
|00000250| 63 72 69 70 74 69 6f 6e | 20 6f 66 20 74 68 65 20 |cription| of the |
|00000260| 4d 61 63 54 43 50 20 69 | 6e 74 65 72 66 61 63 65 |MacTCP i|nterface|
|00000270| 20 63 61 6e 20 62 65 20 | 66 6f 75 6e 64 20 69 6e | can be |found in|
|00000280| 20 74 68 65 0d 41 70 70 | 6c 65 20 4d 61 63 54 43 | the.App|le MacTC|
|00000290| 50 20 41 50 49 20 64 6f | 63 75 6d 65 6e 74 61 74 |P API do|cumentat|
|000002a0| 69 6f 6e 2e 0d 0d 5c 62 | 65 67 69 6e 7b 66 75 6e |ion...\b|egin{fun|
|000002b0| 63 64 65 73 63 7d 7b 4d | 54 55 7d 7b 7d 0d 52 65 |cdesc}{M|TU}{}.Re|
|000002c0| 74 75 72 6e 20 74 68 65 | 20 4d 61 78 69 6d 75 6d |turn the| Maximum|
|000002d0| 20 54 72 61 6e 73 6d 69 | 74 20 55 6e 69 74 20 28 | Transmi|t Unit (|
|000002e0| 74 68 65 20 70 61 63 6b | 65 74 20 73 69 7a 65 29 |the pack|et size)|
|000002f0| 20 6f 66 20 74 68 65 20 | 6e 65 74 77 6f 72 6b 0d | of the |network.|
|00000300| 69 6e 74 65 72 66 61 63 | 65 2e 0d 5c 65 6e 64 7b |interfac|e..\end{|
|00000310| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00000320| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 49 50 41 64 |n{funcde|sc}{IPAd|
|00000330| 64 72 7d 7b 7d 0d 52 65 | 74 75 72 6e 20 74 68 65 |dr}{}.Re|turn the|
|00000340| 20 33 32 2d 62 69 74 20 | 69 6e 74 65 67 65 72 20 | 32-bit |integer |
|00000350| 49 50 20 61 64 64 72 65 | 73 73 20 6f 66 20 74 68 |IP addre|ss of th|
|00000360| 65 20 6e 65 74 77 6f 72 | 6b 20 69 6e 74 65 72 66 |e networ|k interf|
|00000370| 61 63 65 2e 0d 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ace..\en|d{funcde|
|00000380| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000390| 64 65 73 63 7d 7b 4e 65 | 74 4d 61 73 6b 7d 7b 7d |desc}{Ne|tMask}{}|
|000003a0| 0d 52 65 74 75 72 6e 20 | 74 68 65 20 33 32 2d 62 |.Return |the 32-b|
|000003b0| 69 74 20 69 6e 74 65 67 | 65 72 20 6e 65 74 77 6f |it integ|er netwo|
|000003c0| 72 6b 20 6d 61 73 6b 20 | 6f 66 20 74 68 65 20 69 |rk mask |of the i|
|000003d0| 6e 74 65 72 66 61 63 65 | 2e 0d 5c 65 6e 64 7b 66 |nterface|..\end{f|
|000003e0| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000003f0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 54 43 50 43 72 |{funcdes|c}{TCPCr|
|00000400| 65 61 74 65 7d 7b 73 69 | 7a 65 7d 0d 43 72 65 61 |eate}{si|ze}.Crea|
|00000410| 74 65 20 61 20 54 43 50 | 20 53 74 72 65 61 6d 20 |te a TCP| Stream |
|00000420| 6f 62 6a 65 63 74 2e 20 | 5c 76 61 72 7b 73 69 7a |object. |\var{siz|
|00000430| 65 7d 20 69 73 20 74 68 | 65 20 73 69 7a 65 20 6f |e} is th|e size o|
|00000440| 66 20 74 68 65 20 72 65 | 63 65 69 76 65 0d 62 75 |f the re|ceive.bu|
|00000450| 66 66 65 72 2c 20 5c 63 | 6f 64 65 7b 34 30 39 36 |ffer, \c|ode{4096|
|00000460| 7d 20 69 73 20 73 75 67 | 67 65 73 74 65 64 20 62 |} is sug|gested b|
|00000470| 79 20 76 61 72 69 6f 75 | 73 20 73 6f 75 72 63 65 |y variou|s source|
|00000480| 73 2e 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |s..\end{|funcdesc|
|00000490| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|000004a0| 73 63 7d 7b 55 44 50 43 | 72 65 61 74 65 7d 7b 73 |sc}{UDPC|reate}{s|
|000004b0| 69 7a 65 2c 20 70 6f 72 | 74 7d 0d 43 72 65 61 74 |ize, por|t}.Creat|
|000004c0| 65 20 61 20 55 44 50 20 | 73 74 72 65 61 6d 20 6f |e a UDP |stream o|
|000004d0| 62 6a 65 63 74 2e 20 5c | 76 61 72 7b 73 69 7a 65 |bject. \|var{size|
|000004e0| 7d 20 69 73 20 74 68 65 | 20 73 69 7a 65 20 6f 66 |} is the| size of|
|000004f0| 20 74 68 65 20 72 65 63 | 65 69 76 65 0d 62 75 66 | the rec|eive.buf|
|00000500| 66 65 72 20 28 61 6e 64 | 2c 20 68 65 6e 63 65 2c |fer (and|, hence,|
|00000510| 20 74 68 65 20 73 69 7a | 65 20 6f 66 20 74 68 65 | the siz|e of the|
|00000520| 20 62 69 67 67 65 73 74 | 20 64 61 74 61 67 72 61 | biggest| datagra|
|00000530| 6d 20 79 6f 75 20 63 61 | 6e 20 72 65 63 65 69 76 |m you ca|n receiv|
|00000540| 65 0d 6f 6e 20 74 68 69 | 73 20 70 6f 72 74 29 2e |e.on thi|s port).|
|00000550| 20 5c 76 61 72 7b 70 6f | 72 74 7d 20 69 73 20 74 | \var{po|rt} is t|
|00000560| 68 65 20 55 44 50 20 70 | 6f 72 74 20 6e 75 6d 62 |he UDP p|ort numb|
|00000570| 65 72 20 79 6f 75 20 77 | 61 6e 74 20 74 6f 20 72 |er you w|ant to r|
|00000580| 65 63 65 69 76 65 0d 64 | 61 74 61 67 72 61 6d 73 |eceive.d|atagrams|
|00000590| 20 6f 6e 2c 20 61 20 76 | 61 6c 75 65 20 6f 66 20 | on, a v|alue of |
|000005a0| 7a 65 72 6f 20 77 69 6c | 6c 20 6d 61 6b 65 20 4d |zero wil|l make M|
|000005b0| 61 63 54 43 50 20 73 65 | 6c 65 63 74 20 61 20 66 |acTCP se|lect a f|
|000005c0| 72 65 65 20 70 6f 72 74 | 2e 0d 5c 65 6e 64 7b 66 |ree port|..\end{f|
|000005d0| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 73 75 62 73 65 |uncdesc}|..\subse|
|000005e0| 63 74 69 6f 6e 7b 54 43 | 50 20 53 74 72 65 61 6d |ction{TC|P Stream|
|000005f0| 20 4f 62 6a 65 63 74 73 | 7d 0d 0d 5c 72 65 6e 65 | Objects|}..\rene|
|00000600| 77 63 6f 6d 6d 61 6e 64 | 7b 5c 69 6e 64 65 78 73 |wcommand|{\indexs|
|00000610| 75 62 69 74 65 6d 7d 7b | 28 54 43 50 20 73 74 72 |ubitem}{|(TCP str|
|00000620| 65 61 6d 20 61 74 74 72 | 69 62 75 74 65 29 7d 0d |eam attr|ibute)}.|
|00000630| 0d 5c 62 65 67 69 6e 7b | 64 61 74 61 64 65 73 63 |.\begin{|datadesc|
|00000640| 7d 7b 61 73 72 7d 0d 57 | 68 65 6e 20 73 65 74 20 |}{asr}.W|hen set |
|00000650| 74 6f 20 61 20 76 61 6c | 75 65 20 64 69 66 66 65 |to a val|ue diffe|
|00000660| 72 65 6e 74 20 74 68 61 | 6e 20 5c 63 6f 64 65 7b |rent tha|n \code{|
|00000670| 4e 6f 6e 65 7d 20 74 68 | 69 73 20 73 68 6f 75 6c |None} th|is shoul|
|00000680| 64 20 70 6f 69 6e 74 20 | 74 6f 20 61 0d 66 75 6e |d point |to a.fun|
|00000690| 63 74 69 6f 6e 20 77 69 | 74 68 20 74 77 6f 20 69 |ction wi|th two i|
|000006a0| 6e 74 65 67 65 72 20 70 | 61 72 61 6d 65 74 65 72 |nteger p|arameter|
|000006b0| 73 3a 5c 20 61 6e 20 65 | 76 65 6e 74 20 63 6f 64 |s:\ an e|vent cod|
|000006c0| 65 20 61 6e 64 20 61 20 | 64 65 74 61 69 6c 2e 20 |e and a |detail. |
|000006d0| 54 68 69 73 0d 66 75 6e | 63 74 69 6f 6e 20 77 69 |This.fun|ction wi|
|000006e0| 6c 6c 20 62 65 20 63 61 | 6c 6c 65 64 20 75 70 6f |ll be ca|lled upo|
|000006f0| 6e 20 6e 65 74 77 6f 72 | 6b 2d 67 65 6e 65 72 61 |n networ|k-genera|
|00000700| 74 65 64 20 65 76 65 6e | 74 73 20 73 75 63 68 20 |ted even|ts such |
|00000710| 61 73 20 75 72 67 65 6e | 74 0d 64 61 74 61 20 61 |as urgen|t.data a|
|00000720| 72 72 69 76 61 6c 2e 20 | 49 6e 20 61 64 64 69 74 |rrival. |In addit|
|00000730| 69 6f 6e 2c 20 69 74 20 | 69 73 20 63 61 6c 6c 65 |ion, it |is calle|
|00000740| 64 20 77 69 74 68 20 65 | 76 65 6e 74 63 6f 64 65 |d with e|ventcode|
|00000750| 0d 5c 63 6f 64 65 7b 4d | 41 43 54 43 50 2e 50 61 |.\code{M|ACTCP.Pa|
|00000760| 73 73 69 76 65 4f 70 65 | 6e 44 6f 6e 65 7d 20 77 |ssiveOpe|nDone} w|
|00000770| 68 65 6e 20 61 20 5c 63 | 6f 64 65 7b 50 61 73 73 |hen a \c|ode{Pass|
|00000780| 69 76 65 4f 70 65 6e 7d | 20 63 6f 6d 70 6c 65 74 |iveOpen}| complet|
|00000790| 65 73 2e 20 54 68 69 73 | 0d 69 73 20 61 20 50 79 |es. This|.is a Py|
|000007a0| 74 68 6f 6e 20 61 64 64 | 69 74 69 6f 6e 20 74 6f |thon add|ition to|
|000007b0| 20 74 68 65 20 4d 61 63 | 54 43 50 20 73 65 6d 61 | the Mac|TCP sema|
|000007c0| 6e 74 69 63 73 2e 0d 49 | 74 20 69 73 20 73 61 66 |ntics..I|t is saf|
|000007d0| 65 20 74 6f 20 64 6f 20 | 66 75 72 74 68 65 72 20 |e to do |further |
|000007e0| 63 61 6c 6c 73 20 66 72 | 6f 6d 20 74 68 65 20 5c |calls fr|om the \|
|000007f0| 63 6f 64 65 7b 61 73 72 | 7d 2e 0d 5c 65 6e 64 7b |code{asr|}..\end{|
|00000800| 64 61 74 61 64 65 73 63 | 7d 0d 0d 5c 72 65 6e 65 |datadesc|}..\rene|
|00000810| 77 63 6f 6d 6d 61 6e 64 | 7b 5c 69 6e 64 65 78 73 |wcommand|{\indexs|
|00000820| 75 62 69 74 65 6d 7d 7b | 28 54 43 50 20 73 74 72 |ubitem}{|(TCP str|
|00000830| 65 61 6d 20 6d 65 74 68 | 6f 64 29 7d 0d 0d 5c 62 |eam meth|od)}..\b|
|00000840| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 50 |egin{fun|cdesc}{P|
|00000850| 61 73 73 69 76 65 4f 70 | 65 6e 7d 7b 70 6f 72 74 |assiveOp|en}{port|
|00000860| 7d 0d 57 61 69 74 20 66 | 6f 72 20 61 6e 20 69 6e |}.Wait f|or an in|
|00000870| 63 6f 6d 69 6e 67 20 63 | 6f 6e 6e 65 63 74 69 6f |coming c|onnectio|
|00000880| 6e 20 6f 6e 20 54 43 50 | 20 70 6f 72 74 20 5c 76 |n on TCP| port \v|
|00000890| 61 72 7b 70 6f 72 74 7d | 20 28 7a 65 72 6f 20 6d |ar{port}| (zero m|
|000008a0| 61 6b 65 73 20 74 68 65 | 0d 73 79 73 74 65 6d 20 |akes the|.system |
|000008b0| 70 69 63 6b 20 61 20 66 | 72 65 65 20 70 6f 72 74 |pick a f|ree port|
|000008c0| 29 2e 20 54 68 65 20 63 | 61 6c 6c 20 72 65 74 75 |). The c|all retu|
|000008d0| 72 6e 73 20 69 6d 6d 65 | 64 69 61 74 65 6c 79 2c |rns imme|diately,|
|000008e0| 20 61 6e 64 20 79 6f 75 | 20 73 68 6f 75 6c 64 0d | and you| should.|
|000008f0| 75 73 65 20 5c 76 61 72 | 7b 77 61 69 74 7d 20 74 |use \var|{wait} t|
|00000900| 6f 20 77 61 69 74 20 66 | 6f 72 20 63 6f 6d 70 6c |o wait f|or compl|
|00000910| 65 74 69 6f 6e 2e 20 59 | 6f 75 20 73 68 6f 75 6c |etion. Y|ou shoul|
|00000920| 64 20 6e 6f 74 20 69 73 | 73 75 65 20 61 6e 79 20 |d not is|sue any |
|00000930| 6d 65 74 68 6f 64 0d 63 | 61 6c 6c 73 20 6f 74 68 |method.c|alls oth|
|00000940| 65 72 20 74 68 61 6e 0d | 5c 63 6f 64 65 7b 77 61 |er than.|\code{wa|
|00000950| 69 74 7d 2c 20 5c 63 6f | 64 65 7b 69 73 64 6f 6e |it}, \co|de{isdon|
|00000960| 65 7d 20 6f 72 20 5c 63 | 6f 64 65 7b 47 65 74 53 |e} or \c|ode{GetS|
|00000970| 6f 63 6b 4e 61 6d 65 7d | 20 62 65 66 6f 72 65 20 |ockName}| before |
|00000980| 74 68 65 20 63 61 6c 6c | 0d 63 6f 6d 70 6c 65 74 |the call|.complet|
|00000990| 65 73 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |es..\end|{funcdes|
|000009a0| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|000009b0| 65 73 63 7d 7b 77 61 69 | 74 7d 7b 7d 0d 57 61 69 |esc}{wai|t}{}.Wai|
|000009c0| 74 20 66 6f 72 20 5c 63 | 6f 64 65 7b 50 61 73 73 |t for \c|ode{Pass|
|000009d0| 69 76 65 4f 70 65 6e 7d | 20 74 6f 20 63 6f 6d 70 |iveOpen}| to comp|
|000009e0| 6c 65 74 65 2e 0d 5c 65 | 6e 64 7b 66 75 6e 63 64 |lete..\e|nd{funcd|
|000009f0| 65 73 63 7d 0d 0d 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00000a00| 63 64 65 73 63 7d 7b 69 | 73 64 6f 6e 65 7d 7b 7d |cdesc}{i|sdone}{}|
|00000a10| 0d 52 65 74 75 72 6e 20 | 31 20 69 66 20 61 20 5c |.Return |1 if a \|
|00000a20| 63 6f 64 65 7b 50 61 73 | 73 69 76 65 4f 70 65 6e |code{Pas|siveOpen|
|00000a30| 7d 20 68 61 73 20 63 6f | 6d 70 6c 65 74 65 64 2e |} has co|mpleted.|
|00000a40| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00000a50| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00000a60| 7d 7b 47 65 74 53 6f 63 | 6b 4e 61 6d 65 7d 7b 7d |}{GetSoc|kName}{}|
|00000a70| 0d 52 65 74 75 72 6e 20 | 74 68 65 20 54 43 50 20 |.Return |the TCP |
|00000a80| 61 64 64 72 65 73 73 20 | 6f 66 20 74 68 69 73 20 |address |of this |
|00000a90| 73 69 64 65 20 6f 66 20 | 61 20 63 6f 6e 6e 65 63 |side of |a connec|
|00000aa0| 74 69 6f 6e 20 61 73 20 | 61 20 32 2d 74 75 70 6c |tion as |a 2-tupl|
|00000ab0| 65 0d 5c 63 6f 64 65 7b | 28 68 6f 73 74 2c 20 70 |e.\code{|(host, p|
|00000ac0| 6f 72 74 29 7d 2c 20 62 | 6f 74 68 20 69 6e 74 65 |ort)}, b|oth inte|
|00000ad0| 67 65 72 73 2e 0d 5c 65 | 6e 64 7b 66 75 6e 63 64 |gers..\e|nd{funcd|
|00000ae0| 65 73 63 7d 0d 0d 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00000af0| 63 64 65 73 63 7d 7b 41 | 63 74 69 76 65 4f 70 65 |cdesc}{A|ctiveOpe|
|00000b00| 6e 7d 7b 6c 70 6f 72 74 | 5c 2c 20 68 6f 73 74 5c |n}{lport|\, host\|
|00000b10| 2c 20 72 70 6f 72 74 7d | 0d 4f 70 65 6e 20 61 6e |, rport}|.Open an|
|00000b20| 20 6f 75 74 67 6f 69 6e | 67 20 63 6f 6e 6e 65 63 | outgoin|g connec|
|00000b30| 74 69 6f 6e 20 74 6f 20 | 54 43 50 20 61 64 64 72 |tion to |TCP addr|
|00000b40| 65 73 73 20 5c 63 6f 64 | 65 7b 28 5c 76 61 72 7b |ess \cod|e{(\var{|
|00000b50| 68 6f 73 74 7d 2c 20 5c | 76 61 72 7b 72 70 6f 72 |host}, \|var{rpor|
|00000b60| 74 7d 29 7d 2e 20 55 73 | 65 0d 6c 6f 63 61 6c 20 |t})}. Us|e.local |
|00000b70| 70 6f 72 74 20 5c 76 61 | 72 7b 6c 70 6f 72 74 7d |port \va|r{lport}|
|00000b80| 20 28 7a 65 72 6f 20 6d | 61 6b 65 73 20 74 68 65 | (zero m|akes the|
|00000b90| 20 73 79 73 74 65 6d 20 | 70 69 63 6b 20 61 20 66 | system |pick a f|
|00000ba0| 72 65 65 20 70 6f 72 74 | 29 2e 20 54 68 69 73 0d |ree port|). This.|
|00000bb0| 63 61 6c 6c 20 62 6c 6f | 63 6b 73 20 75 6e 74 69 |call blo|cks unti|
|00000bc0| 6c 20 74 68 65 20 63 6f | 6e 6e 65 63 74 69 6f 6e |l the co|nnection|
|00000bd0| 20 68 61 73 20 62 65 65 | 6e 20 65 73 74 61 62 6c | has bee|n establ|
|00000be0| 69 73 68 65 64 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 |ished..\|end{func|
|00000bf0| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000c00| 6e 63 64 65 73 63 7d 7b | 53 65 6e 64 7d 7b 62 75 |ncdesc}{|Send}{bu|
|00000c10| 66 5c 2c 20 70 75 73 68 | 5c 2c 20 75 72 67 65 6e |f\, push|\, urgen|
|00000c20| 74 7d 0d 53 65 6e 64 20 | 64 61 74 61 20 5c 76 61 |t}.Send |data \va|
|00000c30| 72 7b 62 75 66 7d 20 6f | 76 65 72 20 74 68 65 20 |r{buf} o|ver the |
|00000c40| 63 6f 6e 6e 65 63 74 69 | 6f 6e 2e 20 5c 76 61 72 |connecti|on. \var|
|00000c50| 7b 50 75 73 68 7d 20 61 | 6e 64 20 5c 76 61 72 7b |{Push} a|nd \var{|
|00000c60| 75 72 67 65 6e 74 7d 0d | 61 72 65 20 66 6c 61 67 |urgent}.|are flag|
|00000c70| 73 20 61 73 20 73 70 65 | 63 69 66 69 65 64 20 62 |s as spe|cified b|
|00000c80| 79 20 74 68 65 20 54 43 | 50 20 73 74 61 6e 64 61 |y the TC|P standa|
|00000c90| 72 64 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |rd..\end|{funcdes|
|00000ca0| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00000cb0| 65 73 63 7d 7b 52 63 76 | 7d 7b 74 69 6d 65 6f 75 |esc}{Rcv|}{timeou|
|00000cc0| 74 7d 0d 52 65 63 65 69 | 76 65 20 64 61 74 61 2e |t}.Recei|ve data.|
|00000cd0| 20 54 68 65 20 63 61 6c | 6c 20 72 65 74 75 72 6e | The cal|l return|
|00000ce0| 73 20 77 68 65 6e 20 5c | 76 61 72 7b 74 69 6d 65 |s when \|var{time|
|00000cf0| 6f 75 74 7d 20 73 65 63 | 6f 6e 64 73 20 68 61 76 |out} sec|onds hav|
|00000d00| 65 20 70 61 73 73 65 64 | 0d 6f 72 20 77 68 65 6e |e passed|.or when|
|00000d10| 20 28 61 63 63 6f 72 64 | 69 6e 67 20 74 6f 20 74 | (accord|ing to t|
|00000d20| 68 65 20 4d 61 63 54 43 | 50 20 64 6f 63 75 6d 65 |he MacTC|P docume|
|00000d30| 6e 74 61 74 69 6f 6e 29 | 20 60 60 61 20 72 65 61 |ntation)| ``a rea|
|00000d40| 73 6f 6e 61 62 6c 65 20 | 61 6d 6f 75 6e 74 0d 6f |sonable |amount.o|
|00000d50| 66 20 64 61 74 61 20 68 | 61 73 20 62 65 65 6e 20 |f data h|as been |
|00000d60| 72 65 63 65 69 76 65 64 | 27 27 2e 20 54 68 65 20 |received|''. The |
|00000d70| 72 65 74 75 72 6e 20 76 | 61 6c 75 65 20 69 73 20 |return v|alue is |
|00000d80| 61 20 33 2d 74 75 70 6c | 65 0d 5c 63 6f 64 65 7b |a 3-tupl|e.\code{|
|00000d90| 28 5c 76 61 72 7b 64 61 | 74 61 7d 2c 20 5c 76 61 |(\var{da|ta}, \va|
|00000da0| 72 7b 75 72 67 65 6e 74 | 7d 2c 20 5c 76 61 72 7b |r{urgent|}, \var{|
|00000db0| 6d 61 72 6b 7d 29 7d 2e | 20 49 66 20 75 72 67 65 |mark})}.| If urge|
|00000dc0| 6e 74 20 64 61 74 61 20 | 69 73 20 6f 75 74 73 74 |nt data |is outst|
|00000dd0| 61 6e 64 69 6e 67 20 5c | 63 6f 64 65 7b 52 63 76 |anding \|code{Rcv|
|00000de0| 7d 0d 77 69 6c 6c 20 61 | 6c 77 61 79 73 20 72 65 |}.will a|lways re|
|00000df0| 74 75 72 6e 20 74 68 61 | 74 20 62 65 66 6f 72 65 |turn tha|t before|
|00000e00| 20 6c 6f 6f 6b 69 6e 67 | 20 61 74 20 61 6e 79 20 | looking| at any |
|00000e10| 6e 6f 72 6d 61 6c 20 64 | 61 74 61 2e 20 54 68 65 |normal d|ata. The|
|00000e20| 20 66 69 72 73 74 0d 63 | 61 6c 6c 20 72 65 74 75 | first.c|all retu|
|00000e30| 72 6e 69 6e 67 20 75 72 | 67 65 6e 74 20 64 61 74 |rning ur|gent dat|
|00000e40| 61 20 77 69 6c 6c 20 68 | 61 76 65 20 74 68 65 20 |a will h|ave the |
|00000e50| 5c 76 61 72 7b 75 72 67 | 65 6e 74 7d 20 66 6c 61 |\var{urg|ent} fla|
|00000e60| 67 20 73 65 74 2c 20 74 | 68 65 0d 6c 61 73 74 20 |g set, t|he.last |
|00000e70| 77 69 6c 6c 20 68 61 76 | 65 20 74 68 65 20 5c 76 |will hav|e the \v|
|00000e80| 61 72 7b 6d 61 72 6b 7d | 20 66 6c 61 67 20 73 65 |ar{mark}| flag se|
|00000e90| 74 2e 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |t..\end{|funcdesc|
|00000ea0| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00000eb0| 73 63 7d 7b 43 6c 6f 73 | 65 7d 7b 7d 0d 54 65 6c |sc}{Clos|e}{}.Tel|
|00000ec0| 6c 20 4d 61 63 54 43 50 | 20 74 68 61 74 20 6e 6f |l MacTCP| that no|
|00000ed0| 20 6d 6f 72 65 20 64 61 | 74 61 20 77 69 6c 6c 20 | more da|ta will |
|00000ee0| 62 65 20 74 72 61 6e 73 | 6d 69 74 74 65 64 20 6f |be trans|mitted o|
|00000ef0| 6e 20 74 68 69 73 0d 63 | 6f 6e 6e 65 63 74 69 6f |n this.c|onnectio|
|00000f00| 6e 2e 20 54 68 65 20 63 | 61 6c 6c 20 72 65 74 75 |n. The c|all retu|
|00000f10| 72 6e 73 20 77 68 65 6e | 20 61 6c 6c 20 64 61 74 |rns when| all dat|
|00000f20| 61 20 68 61 73 20 62 65 | 65 6e 20 61 63 6b 6e 6f |a has be|en ackno|
|00000f30| 77 6c 65 64 67 65 64 20 | 62 79 0d 74 68 65 20 72 |wledged |by.the r|
|00000f40| 65 63 65 69 76 69 6e 67 | 20 73 69 64 65 2e 0d 5c |eceiving| side..\|
|00000f50| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000f60| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000f70| 41 62 6f 72 74 7d 7b 7d | 0d 46 6f 72 63 69 62 6c |Abort}{}|.Forcibl|
|00000f80| 79 20 63 6c 6f 73 65 20 | 62 6f 74 68 20 73 69 64 |y close |both sid|
|00000f90| 65 73 20 6f 66 20 61 20 | 63 6f 6e 6e 65 63 74 69 |es of a |connecti|
|00000fa0| 6f 6e 2c 20 69 67 6e 6f | 72 69 6e 67 20 6f 75 74 |on, igno|ring out|
|00000fb0| 73 74 61 6e 64 69 6e 67 | 20 64 61 74 61 2e 0d 5c |standing| data..\|
|00000fc0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000fd0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000fe0| 53 74 61 74 75 73 7d 7b | 7d 0d 52 65 74 75 72 6e |Status}{|}.Return|
|00000ff0| 20 61 20 54 43 50 20 73 | 74 61 74 75 73 20 6f 62 | a TCP s|tatus ob|
|00001000| 6a 65 63 74 20 66 6f 72 | 20 74 68 69 73 20 73 74 |ject for| this st|
|00001010| 72 65 61 6d 20 67 69 76 | 69 6e 67 20 74 68 65 20 |ream giv|ing the |
|00001020| 63 75 72 72 65 6e 74 20 | 73 74 61 74 75 73 0d 28 |current |status.(|
|00001030| 73 65 65 20 62 65 6c 6f | 77 29 2e 0d 5c 65 6e 64 |see belo|w)..\end|
|00001040| 7b 66 75 6e 63 64 65 73 | 63 7d 0d 0d 5c 73 75 62 |{funcdes|c}..\sub|
|00001050| 73 65 63 74 69 6f 6e 7b | 54 43 50 20 53 74 61 74 |section{|TCP Stat|
|00001060| 75 73 20 4f 62 6a 65 63 | 74 73 7d 0d 54 68 69 73 |us Objec|ts}.This|
|00001070| 20 6f 62 6a 65 63 74 20 | 68 61 73 20 6e 6f 20 6d | object |has no m|
|00001080| 65 74 68 6f 64 73 2c 20 | 6f 6e 6c 79 20 73 6f 6d |ethods, |only som|
|00001090| 65 20 6d 65 6d 62 65 72 | 73 20 68 6f 6c 64 69 6e |e member|s holdin|
|000010a0| 67 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 6f 6e |g inform|ation on|
|000010b0| 0d 74 68 65 20 63 6f 6e | 6e 65 63 74 69 6f 6e 2e |.the con|nection.|
|000010c0| 20 41 20 63 6f 6d 70 6c | 65 74 65 20 64 65 73 63 | A compl|ete desc|
|000010d0| 72 69 70 74 69 6f 6e 20 | 6f 66 20 61 6c 6c 20 66 |ription |of all f|
|000010e0| 69 65 6c 64 73 20 69 6e | 20 74 68 69 73 20 6f 62 |ields in| this ob|
|000010f0| 6a 65 63 74 73 0d 63 61 | 6e 20 62 65 20 66 6f 75 |jects.ca|n be fou|
|00001100| 6e 64 20 69 6e 20 74 68 | 65 20 41 70 70 6c 65 20 |nd in th|e Apple |
|00001110| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 2e 20 54 |document|ation. T|
|00001120| 68 65 20 6d 6f 73 74 20 | 69 6e 74 65 72 65 73 74 |he most |interest|
|00001130| 69 6e 67 20 6f 6e 65 73 | 20 61 72 65 3a 0d 0d 5c |ing ones| are:..\|
|00001140| 72 65 6e 65 77 63 6f 6d | 6d 61 6e 64 7b 5c 69 6e |renewcom|mand{\in|
|00001150| 64 65 78 73 75 62 69 74 | 65 6d 7d 7b 28 54 43 50 |dexsubit|em}{(TCP|
|00001160| 20 73 74 61 74 75 73 20 | 61 74 74 72 69 62 75 74 | status |attribut|
|00001170| 65 29 7d 0d 0d 5c 62 65 | 67 69 6e 7b 64 61 74 61 |e)}..\be|gin{data|
|00001180| 64 65 73 63 7d 7b 6c 6f | 63 61 6c 48 6f 73 74 7d |desc}{lo|calHost}|
|00001190| 0d 5c 64 61 74 61 6c 69 | 6e 65 7b 6c 6f 63 61 6c |.\datali|ne{local|
|000011a0| 50 6f 72 74 7d 0d 5c 64 | 61 74 61 6c 69 6e 65 7b |Port}.\d|ataline{|
|000011b0| 72 65 6d 6f 74 65 48 6f | 73 74 7d 0d 5c 64 61 74 |remoteHo|st}.\dat|
|000011c0| 61 6c 69 6e 65 7b 72 65 | 6d 6f 74 65 50 6f 72 74 |aline{re|motePort|
|000011d0| 7d 0d 54 68 65 20 69 6e | 74 65 67 65 72 20 49 50 |}.The in|teger IP|
|000011e0| 2d 61 64 64 72 65 73 73 | 65 73 20 61 6e 64 20 70 |-address|es and p|
|000011f0| 6f 72 74 20 6e 75 6d 62 | 65 72 73 20 6f 66 20 62 |ort numb|ers of b|
|00001200| 6f 74 68 20 65 6e 64 70 | 6f 69 6e 74 73 20 6f 66 |oth endp|oints of|
|00001210| 20 74 68 65 0d 63 6f 6e | 6e 65 63 74 69 6f 6e 2e | the.con|nection.|
|00001220| 20 0d 5c 65 6e 64 7b 64 | 61 74 61 64 65 73 63 7d | .\end{d|atadesc}|
|00001230| 0d 0d 5c 62 65 67 69 6e | 7b 64 61 74 61 64 65 73 |..\begin|{datades|
|00001240| 63 7d 7b 73 65 6e 64 57 | 69 6e 64 6f 77 7d 0d 54 |c}{sendW|indow}.T|
|00001250| 68 65 20 63 75 72 72 65 | 6e 74 20 77 69 6e 64 6f |he curre|nt windo|
|00001260| 77 20 73 69 7a 65 2e 0d | 5c 65 6e 64 7b 64 61 74 |w size..|\end{dat|
|00001270| 61 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 64 |adesc}..|\begin{d|
|00001280| 61 74 61 64 65 73 63 7d | 7b 61 6d 74 55 6e 61 63 |atadesc}|{amtUnac|
|00001290| 6b 65 64 44 61 74 61 7d | 0d 54 68 65 20 6e 75 6d |kedData}|.The num|
|000012a0| 62 65 72 20 6f 66 20 62 | 79 74 65 73 20 73 65 6e |ber of b|ytes sen|
|000012b0| 74 20 62 75 74 20 6e 6f | 74 20 79 65 74 20 61 63 |t but no|t yet ac|
|000012c0| 6b 6e 6f 77 6c 65 64 67 | 65 64 2e 20 5c 63 6f 64 |knowledg|ed. \cod|
|000012d0| 65 7b 73 65 6e 64 57 69 | 6e 64 6f 77 20 2d 0d 61 |e{sendWi|ndow -.a|
|000012e0| 6d 74 55 6e 61 63 6b 65 | 64 44 61 74 61 7d 20 69 |mtUnacke|dData} i|
|000012f0| 73 20 77 68 61 74 20 79 | 6f 75 20 63 61 6e 20 70 |s what y|ou can p|
|00001300| 61 73 73 20 74 6f 20 5c | 63 6f 64 65 7b 53 65 6e |ass to \|code{Sen|
|00001310| 64 7d 20 77 69 74 68 6f | 75 74 20 62 6c 6f 63 6b |d} witho|ut block|
|00001320| 69 6e 67 2e 0d 5c 65 6e | 64 7b 64 61 74 61 64 65 |ing..\en|d{datade|
|00001330| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 64 61 74 61 |sc}..\be|gin{data|
|00001340| 64 65 73 63 7d 7b 61 6d | 74 55 6e 72 65 61 64 44 |desc}{am|tUnreadD|
|00001350| 61 74 61 7d 0d 54 68 65 | 20 6e 75 6d 62 65 72 20 |ata}.The| number |
|00001360| 6f 66 20 62 79 74 65 73 | 20 72 65 63 65 69 76 65 |of bytes| receive|
|00001370| 64 20 62 75 74 20 6e 6f | 74 20 79 65 74 20 72 65 |d but no|t yet re|
|00001380| 61 64 20 28 77 68 61 74 | 20 79 6f 75 20 63 61 6e |ad (what| you can|
|00001390| 20 5c 63 6f 64 65 7b 52 | 65 63 76 7d 0d 77 69 74 | \code{R|ecv}.wit|
|000013a0| 68 6f 75 74 20 62 6c 6f | 63 6b 69 6e 67 29 2e 0d |hout blo|cking)..|
|000013b0| 5c 65 6e 64 7b 64 61 74 | 61 64 65 73 63 7d 0d 0d |\end{dat|adesc}..|
|000013c0| 0d 0d 5c 73 75 62 73 65 | 63 74 69 6f 6e 7b 55 44 |..\subse|ction{UD|
|000013d0| 50 20 53 74 72 65 61 6d | 20 4f 62 6a 65 63 74 73 |P Stream| Objects|
|000013e0| 7d 0d 4e 6f 74 65 20 74 | 68 61 74 2c 20 75 6e 6c |}.Note t|hat, unl|
|000013f0| 69 6b 65 20 74 68 65 20 | 6e 61 6d 65 20 73 75 67 |ike the |name sug|
|00001400| 67 65 73 74 73 2c 20 74 | 68 65 72 65 20 69 73 20 |gests, t|here is |
|00001410| 6e 6f 74 68 69 6e 67 20 | 73 74 72 65 61 6d 2d 6c |nothing |stream-l|
|00001420| 69 6b 65 0d 61 62 6f 75 | 74 20 55 44 50 2e 0d 0d |ike.abou|t UDP...|
|00001430| 5c 72 65 6e 65 77 63 6f | 6d 6d 61 6e 64 7b 5c 69 |\renewco|mmand{\i|
|00001440| 6e 64 65 78 73 75 62 69 | 74 65 6d 7d 7b 28 55 44 |ndexsubi|tem}{(UD|
|00001450| 50 20 73 74 72 65 61 6d | 20 61 74 74 72 69 62 75 |P stream| attribu|
|00001460| 74 65 29 7d 0d 0d 5c 62 | 65 67 69 6e 7b 64 61 74 |te)}..\b|egin{dat|
|00001470| 61 64 65 73 63 7d 7b 61 | 73 72 7d 0d 54 68 65 20 |adesc}{a|sr}.The |
|00001480| 61 73 79 6e 63 68 72 6f | 6e 6f 75 73 20 73 65 72 |asynchro|nous ser|
|00001490| 76 69 63 65 20 72 6f 75 | 74 69 6e 65 20 74 6f 20 |vice rou|tine to |
|000014a0| 62 65 20 63 61 6c 6c 65 | 64 20 6f 6e 20 65 76 65 |be calle|d on eve|
|000014b0| 6e 74 73 20 73 75 63 68 | 20 61 73 0d 64 61 74 61 |nts such| as.data|
|000014c0| 67 72 61 6d 20 61 72 72 | 69 76 61 6c 20 77 69 74 |gram arr|ival wit|
|000014d0| 68 6f 75 74 20 6f 75 74 | 73 74 61 6e 64 69 6e 67 |hout out|standing|
|000014e0| 20 5c 63 6f 64 65 7b 52 | 65 61 64 7d 20 63 61 6c | \code{R|ead} cal|
|000014f0| 6c 2e 20 54 68 65 20 5c | 63 6f 64 65 7b 61 73 72 |l. The \|code{asr|
|00001500| 7d 20 68 61 73 20 61 0d | 73 69 6e 67 6c 65 20 61 |} has a.|single a|
|00001510| 72 67 75 6d 65 6e 74 2c | 20 74 68 65 20 65 76 65 |rgument,| the eve|
|00001520| 6e 74 20 63 6f 64 65 2e | 0d 5c 65 6e 64 7b 64 61 |nt code.|.\end{da|
|00001530| 74 61 64 65 73 63 7d 0d | 0d 5c 62 65 67 69 6e 7b |tadesc}.|.\begin{|
|00001540| 64 61 74 61 64 65 73 63 | 7d 7b 70 6f 72 74 7d 0d |datadesc|}{port}.|
|00001550| 41 20 72 65 61 64 2d 6f | 6e 6c 79 20 6d 65 6d 62 |A read-o|nly memb|
|00001560| 65 72 20 67 69 76 69 6e | 67 20 74 68 65 20 70 6f |er givin|g the po|
|00001570| 72 74 20 6e 75 6d 62 65 | 72 20 6f 66 20 74 68 69 |rt numbe|r of thi|
|00001580| 73 20 55 44 50 20 73 74 | 72 65 61 6d 2e 0d 5c 65 |s UDP st|ream..\e|
|00001590| 6e 64 7b 64 61 74 61 64 | 65 73 63 7d 0d 0d 5c 72 |nd{datad|esc}..\r|
|000015a0| 65 6e 65 77 63 6f 6d 6d | 61 6e 64 7b 5c 69 6e 64 |enewcomm|and{\ind|
|000015b0| 65 78 73 75 62 69 74 65 | 6d 7d 7b 28 55 44 50 20 |exsubite|m}{(UDP |
|000015c0| 73 74 72 65 61 6d 20 6d | 65 74 68 6f 64 29 7d 0d |stream m|ethod)}.|
|000015d0| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|000015e0| 7d 7b 52 65 61 64 7d 7b | 74 69 6d 65 6f 75 74 7d |}{Read}{|timeout}|
|000015f0| 0d 52 65 61 64 20 61 20 | 64 61 74 61 67 72 61 6d |.Read a |datagram|
|00001600| 2c 20 77 61 69 74 69 6e | 67 20 61 74 20 6d 6f 73 |, waitin|g at mos|
|00001610| 74 20 5c 76 61 72 7b 74 | 69 6d 65 6f 75 74 7d 20 |t \var{t|imeout} |
|00001620| 73 65 63 6f 6e 64 73 20 | 28 24 2d 31 24 20 69 73 |seconds |($-1$ is|
|00001630| 0d 69 6e 66 69 6e 69 74 | 65 29 2e 20 20 52 65 74 |.infinit|e).  Ret|
|00001640| 75 72 6e 20 74 68 65 20 | 64 61 74 61 2e 0d 5c 65 |urn the |data..\e|
|00001650| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00001660| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 57 |egin{fun|cdesc}{W|
|00001670| 72 69 74 65 7d 7b 68 6f | 73 74 5c 2c 20 70 6f 72 |rite}{ho|st\, por|
|00001680| 74 5c 2c 20 62 75 66 7d | 0d 53 65 6e 64 20 5c 76 |t\, buf}|.Send \v|
|00001690| 61 72 7b 62 75 66 7d 20 | 61 73 20 61 20 64 61 74 |ar{buf} |as a dat|
|000016a0| 61 67 72 61 6d 20 74 6f | 20 49 50 2d 61 64 64 72 |agram to| IP-addr|
|000016b0| 65 73 73 20 5c 76 61 72 | 7b 68 6f 73 74 7d 2c 20 |ess \var|{host}, |
|000016c0| 70 6f 72 74 0d 5c 76 61 | 72 7b 70 6f 72 74 7d 2e |port.\va|r{port}.|
|000016d0| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
+--------+-------------------------+-------------------------+--------+--------+